home *** CD-ROM | disk | FTP | other *** search
/ Best of Shareware / Best of PC Windows Shareware 1.0 - Wayzata Technology (7111) (1993).iso / pc / dos / editors / adedt301 / adedit.doc < prev    next >
Text File  |  1988-03-03  |  39KB  |  920 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.               Documentation for AD-EDIT V3.01, updated 03/03/88
  7.  
  8.  
  9.  
  10.               (C) Copyright 1985-88 by Allen Driskill
  11.                   ALL RIGHTS RESERVED
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.       This .DOC file is formatted for printing on 8.5 inch paper at 8 lines
  22.       per inch, or on 11 inch paper at 6 lines/inch.  Assuming this file is
  23.       on the current drive in the current directory, use the DOS "COPY"
  24.       command as follows:
  25.  
  26.                COPY  ADEDIT.DOC LPT1:
  27.  
  28.  
  29.  
  30.      Table of Contents
  31.      -----------------
  32.  
  33.          Topic                                           Page
  34.          ----------------------------------------------- ----
  35.  
  36.          Licensing Information                              1
  37.  
  38.          General Information                                2
  39.  
  40.          List and explanation of distribution files         2
  41.  
  42.          System Requirements and Miscellany                 3
  43.  
  44.          Starting AD-EDIT from the DOS command line         4
  45.  
  46.          Entering strings on the Input Line                 5
  47.  
  48.          Entering parameters via the Esc key                5
  49.  
  50.          Keyboard Layout                                    6
  51.  
  52.          Pick-Close-Put Buffer                             11
  53.  
  54.          Spelling Checker (via Turbo Lightning)            12
  55.  
  56.          Translation Table Files                           13
  57.  
  58.          Turbo Pascal I/O Error Codes                      14
  59.  
  60.          Suggested/Anticipated Enhancements                15
  61.  
  62.          Suggested but Rejected Changes                    16
  63.  
  64.          History of changes                                17
  65.  
  66.          Changing Defaults (Color, Printer, etc)           18
  67.  
  68.  
  69.  
  70.      Licensing Information                                            Page 1
  71.      ---------------------                                            ------
  72.  
  73.      AD-EDIT is a full-screen text editor for the IBM PC and compatibles
  74.      written by:
  75.  
  76.             Allen Driskill
  77.             5193 Taylor Lane Avenue
  78.             Hilliard, Ohio  43026
  79.  
  80.             Phone: (614) 876-0885
  81.  
  82.     and available on several bulletin boards in Columbus, Ohio:
  83.  
  84.             NoChange #12   (614)  764-6744
  85.             C.O.R.E.       (614)  864-2673
  86.  
  87.      AD-EDIT is ShareWare.  You are granted a limited license to use AD-EDIT,
  88.      and to copy and distribute it, providing that the following conditions are
  89.      met:
  90.  
  91.         1. The software is distributed intact (not modified by other
  92.            than the author), including documentation and supplemental
  93.            files
  94.  
  95.         2. There is no charge made for the copy, other than a reasonable
  96.            duplication/media fee which may be charged by clubs or
  97.            organizations for copies given to members or guests.
  98.  
  99.  
  100.      Individuals may become licensed users by sending $10 to the author.
  101.      Licensed users may call (6-10 P.M. EST) or write the author to report
  102.      and obtain fixes for program bugs.  Licensed users are notified by
  103.      mail of significant new releases.
  104.  
  105.      Commercial or governmental organizations may not use this software
  106.      without paying a single-copy license fee of $30.  Site licenses and
  107.      commercial distribution licenses are available; contact the author.
  108.  
  109.      Contributions of less (or more) than $10 are also appreciated.  Unlicensed
  110.      users are free to report bugs, etc, but no obligation will exist to
  111.      fix them or notify such users when bugs are fixed.  Also, advice is not
  112.      provided to, or questions accepted from, unlicensed users except as the
  113.      mood strikes the author.
  114.  
  115.  
  116.      General Information                                              Page 2
  117.      -------------------                                              ------
  118.  
  119.      Distribution of this software, and new updates to this software, is
  120.      generally made available via the public bulletin boards listed above.
  121.      If you send a floppy and a prepaid return mailer, I will distribute
  122.      copies in that form, also.
  123.  
  124.      Any user, licensed or not, is encouraged provide feedback to the
  125.      author on ways to improve AD-EDIT.  Please send feedback via US Mail or
  126.      bulletin board mail, and indicate how I may contact you to discuss
  127.      your ideas.
  128.  
  129.      Distribution Files
  130.      ------------------
  131.  
  132.      In the AD-EDIT distribution package (normally a .ARC file created using
  133.      the PKARC program from PKWare, Inc) you should find the following files:
  134.  
  135.         ADEDIT.DOC      This documentation file
  136.  
  137.         ADEDIT.EXE      The executable AD-EDIT program; feel free to re-name
  138.                         this to any name you like (E.EXE, EDITOR.EXE, etc)
  139.  
  140.         ADEDIT.DEF      Source for creating a LogiTech Mouse menu for AD-EDIT;
  141.                         with minor changes can also be used with Microsoft
  142.                         Mouse software
  143.  
  144.         ADEDIT.DVP      A DESQview 2.00 "Program Information File" for
  145.                         installing AD-EDIT under DESQview 2.00 or above
  146.  
  147.                         **** Translation-table files ****
  148.         ALLPRINT.XLT    Removes all non-printable ASCII characters
  149.         HIGHBITS.XLT    Turns off the high bit of every byte
  150.         NO128S.XLT      Removes all ASCII characters in 128-155 range
  151.         NOCTRL.XLT      Removes all the low (< 32) value bytes
  152.  
  153.  
  154.      System Requirements and miscellany                               Page 3
  155.      ----------------------------------                               ------
  156.  
  157.  
  158.      Memory - at least 128K, the more the better.  Text lines are limited
  159.               to 127 bytes in length.  AD-EDIT memory management is fully
  160.               compatible with DOS; it may be invoked from other DOS applications
  161.               via the "EXEC" system call.
  162.  
  163.               Dynamic memory requirement:
  164.  
  165.                     General Overhead-   32K bytes
  166.                     Each Window     -   100 bytes
  167.                     Each line       -   128 Bytes
  168.  
  169.  
  170.      Monitors -  Should run on any monitor/adapter compatible with the
  171.                IBM Monochrome Display Adapter (MDA) or Color Graphics
  172.                Adapter (CGA) or Enhanced Graphic Adapter (EGA).  AD-EDIT has
  173.                been tested on the IBM PC, XT, AT, 3270PC, Portable, Convertible,
  174.                PS/2 M60, the ITT Xtra, and the IDS Turbo.
  175.  
  176.      Video Management -  Writes directly to video RAM; uses only video page 0.
  177.                Uses a 25 lines by 80 columns screen format at all times.
  178.  
  179.                AD-EDIT is "DESQview Aware", and should be installed with
  180.                "Writes direct to video memory" set to "NO".  DESQview is
  181.                a trademark of Quarterdeck Office Systems.
  182.  
  183.      Language- Borland's TURBO PASCAL V3.0, with some subroutines written in
  184.                Assembly language for speed.
  185.  
  186.      Turbo Lightning (from Borland International) is required to use AD-EDIT's
  187.                spelling checking feature.
  188.  
  189.      Features-
  190.                     - Extremely fast flicker-free scrolling
  191.                     - edit multiple files in multiple "windows"
  192.                     - edit a single file in multiple "windows" (all windows
  193.                       modify the same copy of the file)
  194.                     - block operations: open,close,copy,move blocks of
  195.                       text
  196.                     - exit into DOS, then return to edit session
  197.                     - split and merge files
  198.                     - Word-wrap, line splitting, and line-merging
  199.                     - CAPS mode for all-upper-case editing
  200.                     - character translation abilities
  201.  
  202.  
  203.      Starting AD-EDIT from the DOS command line                       Page 4
  204.      ------------------------------------------                       -------
  205.  
  206.  
  207.      AD-EDIT is started from the DOS command line as follows:
  208.  
  209.  
  210.           ADEDIT [[d:][path][filename[.ext]]] [/B]
  211.  
  212.  
  213.      The first parameter specifies the name of the file to be edited.
  214.      If omitted, AD-EDIT will prompt for the file name.  If no extension is
  215.      supplied, and the filename is not found, then AD-EDIT will check for
  216.      (in order) extensions of .txt, .asm, .bas, .c, .doc, and .pas; the
  217.      first file found is used.
  218.  
  219.      [/B] specifies that AD-EDIT is to run in Black-and-White mode.  The
  220.      default is for AD-EDIT to use color on CGA-compatible adapters, and
  221.      Black-and-White for monochrome adapters.
  222.  
  223.  
  224.      Screen layout
  225.      -------------
  226.  
  227.      AD-EDIT uses a 25 line by 80 column screen format.  The first 24 lines are
  228.      the "data" portion of the screen and are used to display the data within
  229.      the file(s) being edited.
  230.  
  231.      Line 25 serves three functions:
  232.  
  233.         As the "Status Line", it displays information about the current
  234.         "active window":
  235.  
  236.                - the filename being edited
  237.                - The line and column within the file where the cursor is
  238.                  currently positioned
  239.                - The percentage of memory that is still free for use.
  240.                - Whether the WRAP, CAPS and/or INSERT modes are active
  241.  
  242.  
  243.         As the "Input Line", where AD-EDIT prompts for information needed to
  244.         perform or complete some requested operation.  After the requested
  245.         information is provided, the line is cleared and replaced by the
  246.         "Status Line".
  247.  
  248.         As the "Message Line", where AD-EDIT displays error messages.  Generally,
  249.         messages remain visible until the next keystroke, then they are
  250.         cleared and replaced by the "Status Line".
  251.  
  252.  
  253.      Entering strings on the "Input Line"                             Page 5
  254.      ------------------------------------                             ------
  255.  
  256.      Some of the AD-EDIT functions will display a message "prompt" on the bottom
  257.      line of the screen, asking for you to supply a piece of information
  258.      (like "String to be searched for", "Replacement String", etc).  While
  259.      you are entering the information in these cases, a limited set of editing
  260.      functions are available:
  261.  
  262.         - Typing a character does what one would expect (the character appears)
  263.  
  264.         - Using the Cursor-Left and Cursor-Right keys will move the cursor
  265.           to a particular location in the string you're typing
  266.  
  267.         - Pressing the Del key deletes the character at the cursor; everything
  268.           to the right of the cursor shifts left
  269.  
  270.         - Pressing the Ins key will toggle Insert/Overwrite mode (the initial
  271.           state is Overwrite mode) allowing characters to be added within the
  272.           string
  273.  
  274.         - Pressing the backspace key will move the cursor left 1 space, and
  275.           then act just like the Del key
  276.  
  277.         - Pressing the Home key will retrieve previously entered strings, and
  278.           then allow them to be edited
  279.  
  280.         - Pressing the Esc key cancels input of the parameter (the whole deal
  281.           is forgotten)
  282.  
  283.      Entering parameters via ESC key
  284.      -------------------------------
  285.  
  286.      Also, by pressing the ESC key, AD-EDIT will move the cursor to the bottom
  287.      line and wait for input, in which case you can:
  288.  
  289.         - Use the arrow keys to move the cursor: This is called "Cursor-
  290.           defined mode" where you "mark" a group of lines or block of text
  291.           by drawing a box around them (see description of F9 (OPEN) and
  292.           F10 (CLOSE))
  293.  
  294.         - Enter a number to cause the next operation to be repeated a
  295.           certain no. of times (see F9 (OPEN) and F10 (CLOSE))
  296.  
  297.  
  298.      Keyboard layout ("Buttons, Buttons, who's got the buttons")      Page 6
  299.      ---------------                                                  ------
  300.  
  301.      <Up Arrow>
  302.      <Down Arrow>
  303.      <Left Arrow>
  304.      <Right Arrow>  - These keys move the cursor in the indicated
  305.                       direction within the active window.  If the cursor is
  306.                       moved off the edge to the right or left, it will "wrap"
  307.                       and re-appear at the opposite edge.  If the cursor is
  308.                       off the top or bottom, AD-EDIT will scroll the file 1 line
  309.                       in that direction.
  310.  
  311.      <Ctrl-Right Arrow> - Scrolls the file so that the column containing the  cursor is in the left-most column of the window (
  312.                  "right" in the file)
  313.  
  314.      <Ctrl-Left Arrow> - Scrolls the file so that the column containing the
  315.                  cursor is in the right-most column of the window (moves
  316.                  "left" in the file)
  317.  
  318.      <HOME>    - Moves the cursor to the top line of the window without
  319.                  changing columns
  320.  
  321.      <PgUp>    - Scrolls the file so that the line currently containing the
  322.                  cursor is at the bottom of the window (moves "up" in the file).
  323.  
  324.      <Ctrl-PgUp> - Scrolls to the top screen of the file
  325.  
  326.      <PgDn>    - Scrolls the file so that the line currently containing the
  327.                  cursor is at the top of the window (moves "down" in the file).
  328.  
  329.      <Ctrl-PgDn> - Scrolls to the bottom screen of the file
  330.  
  331.      <End>      - Saves changes to the file in the active window and closes the
  332.                   active window.
  333.  
  334.      <Ctrl-End> - Closes the active window WITHOUT saving changes to the
  335.                   file.
  336.  
  337.      <Del>     - Deletes 1 character at the cursor location by shifting all
  338.                  characters to the right of the cursor left 1 column.
  339.  
  340.      <Ins>     - Toggle "Insert mode" on/off
  341.  
  342.      <back-space> - Moves the cursor left one column, then acts like <Del>
  343.  
  344.      <Enter> or <Return>  -  Moves the cursor to the left-most column of the
  345.                       next line in the window.
  346.  
  347.      <tab>     - Moves cursor right to the next tab setting (if any)
  348.  
  349.  
  350.      Keyboard layout (continued)                                      Page 7
  351.      ---------------                                                  -------
  352.  
  353.      <back-tab> - Moves cursor left to the previous tab setting (if any)
  354.  
  355.      <Esc>     - Enters parameter-definition mode:
  356.  
  357.                     - If the next key pressed is one of the <arrow> keys,
  358.                       AD-EDIT enters "Cursor-defined-area mode".  The current
  359.                       cursor location becomes the corner of a box; the
  360.                       opposite corner of the box is defined by the new location
  361.                       of the cursor.  After moving the cursor and/or scrolling
  362.                       the file to define the block to be acted on, an Fx key
  363.                       is used to specify the action.
  364.  
  365.                     - If the next key pressed is NOT an <arrow> key, then
  366.                       AD-EDIT expects a number to be entered.
  367.  
  368.                While in either mode, pressing <Esc> again will restore AD-EDIT
  369.                to the exact condition existing before <Esc> was pressed the
  370.                first time.
  371.  
  372.  
  373.      <F1>      - "HELP":  Displays a list of the keyboard functions
  374.  
  375.      <F2>       - Set Tab:  Sets a tab-stop at the current cursor column
  376.      <Ctrl-F2>  - Clear Tab:  Clear all Tab positions
  377.  
  378.      <F3>      - Pick up:  Copies an area into the Pick-Close-Put Buffer:
  379.  
  380.                     <F3> Copies the line containing the cursor
  381.  
  382.                     <Esc><5><F3> Copies 5 lines beginning with the cursor line
  383.  
  384.                     <Esc><Cursor-Right 5 times><F3> Copies 5 characters
  385.  
  386.                     <Esc><Cursor-Right 5 times><Cursor-Down 3 times><F3> Copies
  387.                     a 5-columns by 3 lines block of text
  388.  
  389.  
  390.      Keyboard layout (continued)                                      Page 8
  391.      ---------------                                                  ------
  392.  
  393.      <F4>       - Find: Locates a string within the file:
  394.      <Ctrl-F4>  - Repeat previous FIND
  395.  
  396.                      - Will prompt for string to be found
  397.  
  398.                      - Will prompt for FIND options:
  399.  
  400.                           C: Ignore upper/lower (C)ase during search
  401.                           F: Find (F)irst occurrence
  402.                           W: Find only if string occurs as a (W)ord
  403.                           P: Find only if string occurs as a (P)refix
  404.                           S: Find only if string occurs as a (S)uffix
  405.                           R: Find only if string occurs within a (R)ange of
  406.                              columns (will prompt for range)
  407.                           A: Find (A)ll occurrences (only makes sense for
  408.                              CHANGE; see F8)
  409.                           N: (N)oshow; do not display each string as it is
  410.                              found/changed
  411.  
  412.      <F5>       - Put back: Copies the Pick-Close-Put buffer into the file at
  413.                   the current cursor location.
  414.  
  415.      <F6>       - Erase to EOL: Erases all characters to the right of the cursor
  416.  
  417.      <F7>       - Toggle Word-wrap On/Off
  418.  
  419.      <F8>       - Change one string to another
  420.  
  421.                      - Prompts for string to find
  422.                      - Prompts for FIND options (see F4)
  423.                      - Prompts for replacement string
  424.  
  425.  
  426.      <F9>       - Open: Create space in the file
  427.  
  428.                      <F9> opens 1 blank line at line containing cursor
  429.  
  430.                      <Esc><3><F9> opens 3 blank lines
  431.  
  432.                      <Esc><Cursor-Right 5 times><F9> opens 5 blank spaces
  433.  
  434.                      <Esc><Cursor-Right 5 times><Cursor-Down 5 times><F9> Opens
  435.                      a box of 5 columns by 5 lines
  436.  
  437.  
  438.      Keyboard layout (continued)                                      Page 9
  439.      ---------------                                                  ------
  440.  
  441.      <F10>      - Close: Delete space in file, deleted data is moved to the
  442.                   Pick-Close-Put (PCP) buffer
  443.  
  444.                      (See F3, F9 for similar usage)
  445.  
  446.  
  447.      <Ctrl-F1>  - Save file contents using original file name
  448.      <Alt-F1>   - Will prompt for a new filename to be used during save
  449.  
  450.      <Ctrl-F3>  - Get File:   Copy another file into current file at cursor
  451.  
  452.      <Ctrl-F5>  - Save last data Picked-Up or Closed to a file
  453.      <Ctrl-F6>  -  Not Used
  454.  
  455.      <Ctrl-F7>  - Toggle Caps On/Off:  When Caps is ON, characters a-z are
  456.                   translated to A-Z
  457.  
  458.      <Ctrl-F8>  - Repeat Change: Repeat the last CHANGE operation
  459.  
  460.      <Ctrl-F9>  - Break Line: Create a new line with all data to right of
  461.                   the cursor
  462.  
  463.      <Ctrl-F10> - Merge Lines: Append following line to line containing cursor;
  464.                   delete the following line.
  465.  
  466.      <Alt-F1>   - Save PCP Buffer to File
  467.  
  468.      <Alt-F2>   - Open a new window:
  469.  
  470.                      <Alt-F2> creates window with current cursor location as
  471.                               the upper left corner
  472.  
  473.                      <Esc><Move Cursor><Alt-F2> Creates a window in the
  474.                               defined box
  475.  
  476.      <Alt-F3>   - Clear screen and EXEC DOS command-processor.  Typing
  477.                   "exit" will return to the AD-EDIT session
  478.  
  479.      <Alt-F4>   - Zoom active window to full-screen size, or restore to
  480.                   original size.
  481.  
  482.  
  483.      Keyboard layout (continued)                                      Page 10
  484.      ---------------                                                  -------
  485.  
  486.      <Alt-F5>   - Print File: Prints the in-memory copy of the file being
  487.                   edited- will prompt for a printer/file name; just press
  488.                   <CR> to use the default.
  489.  
  490.      <Alt-F6>   - Switch Window: goes through windows "round-robin"
  491.  
  492.      <Alt-F7>   - Invokes spelling checking beginning at the top of the file
  493.  
  494.      <Alt-F8>   - Invokes spelling checking beginning at the next word past
  495.                   the current cursor position
  496.  
  497.      <Alt-F9>   - Perform character translation
  498.  
  499.      <Alt-F10>  - Set type of character translation.  The types available are:
  500.  
  501.                     (U)ppercase - Translates characters `a' through `z' to
  502.                                   `A' through `Z'
  503.  
  504.                     (L)owercase - Translates characters `A' through `Z' to
  505.                                   `a' through `z'
  506.  
  507.                     (T)able     - Loads and uses a Translate Table File
  508.                                   (See `Translate Table Files')
  509.  
  510.  
  511.      Pick-Close-Put (PCP) Buffer  (or "Moving and Copying Text")      Page-------------------
  512.  
  513.      When sections of text (entire lines, or "boxes" of partial lines) are
  514.      either deleted (with the F10 "close" function) or picked up (with the F3
  515.      "pick" function) the text is saved in the Pick-Close-Put (PCP) buffer.
  516.  
  517.      Data in the PCP can be retrieved by the F5 PUT function; thus copying
  518.      a section of text is done by PICKing it, and then Putting it in the new
  519.      location.  Text is moved by Closing it from the old location and Putting
  520.      it at the new location.
  521.  
  522.      When the PCP contains entire lines of text, the PUT function opens
  523.      the appropriate number of lines, and then copies in the PCP data.
  524.      Another way of saying this is that the PCP lines are inserted ahead of the
  525.      line containing the cursor when the "put" key is pressed.
  526.  
  527.      When the PCP contains a "box" of text (portions of one or more lines),
  528.      the "put" key splits the existing file's lines and moves them right, to
  529.      make room for the box of text.  This means that each partial line in the
  530.      PCP will be inserted into a line of the file.
  531.  
  532.      The Ctrl-F5 key also retrieves the contents of the PCP, but writes the
  533.      data to a file.  Thus, to copy a section of text into a new file, "pick" it
  534.      and then use Ctrl-F5.  To move a section of text into a new file, "close"
  535.      the text, and then use Ctrl-F5.
  536.  
  537.  
  538.      The Spelling Checking Interface to Turbo Lightning               Page 12
  539.      --------------------------------------------------               -------
  540.  
  541.  
  542.      Via the Alt-F7 and Alt-F8 keys, an interface to Borland International's
  543.      Turbo Lightning product is invoked.  This allows spelling checking via
  544.      Lightning to be done on a file basis, instead of a word-by-word (as the
  545.      text is being entered) basis or a screen-by-screen (after the fact) basis.
  546.  
  547.      When a spelling error is detected, AD-EDIT pauses with the cursor
  548.      positioned at the offending word.  You may then use the Lightning
  549.      "hotkeys" to identify the correct spelling or synonym replacement.
  550.  
  551.      If Lightning is not installed when the Spell-Check functions are invoked,
  552.      a message is issued and the request is ignored.  To install lightning, exit
  553.      from AD-EDIT and install Lightning per its accompanying directions.
  554.  
  555.      AD-EDIT is fully compatible with Turbo Lightning's "Auto Proof" mode and
  556.      text-replacement functions.  The appropriate environment settings are as
  557.      follows:
  558.  
  559.           Right Arrow Key 1  RGT   (right-arrow cursor key)
  560.           Right Arrow Key 2  None
  561.           Left Arrow Key 1   LFT   (left-arrow cursor key)
  562.           Left Arrow Key 2   None
  563.           Left Arrow Key 3   None
  564.           Backspace Key 1    BKS   (Backspace key)
  565.           Backspace Key 2    None
  566.           Delete Key 1       DEL   ("Del" key)
  567.           Delete Key 2       None
  568.           Insert Toggle 1    INS   ("Ins" Key)
  569.           Insert Toggle 2    None
  570.           Get Words from    Screen
  571.           Piping Delay       000
  572.           Auto Proof         ON/OFF  (However you like)
  573.           Insert/Overwrite
  574.              Starts in Overwrite Mode
  575.  
  576.  
  577.      Translation Table Files                                          Page 13
  578.      -----------------------                                          -------
  579.  
  580.      The <Alt-F10> provides a (T)able translation option that allows the
  581.      loading of customized translation tables.  These tables may be used for
  582.      any purpose, such as these files supplied as part of the AD-EDIT software
  583.      package:
  584.  
  585.          No128s.Xlt   - "No 128s" will translate any character whose binary
  586.                         value is 128 or higher to a blank.
  587.  
  588.          NoCntrl.Xlt  - "No control characters" will translate any character
  589.                         whose binary value is less than 32 (the blank character)
  590.                         to a blank.
  591.  
  592.          AllPrint.Xlt - "All Printable" translates all characters less than 32
  593.                         or greater than 128 to a blank
  594.  
  595.          HighBits.Xlt - "High Bits" will turn off the high-order bit of every
  596.                         character (handy for converting files from some word-
  597.                         processors to true ASCII files)
  598.  
  599.      Users may create their own .Xlt files; the file must be in ASCII format
  600.      (with carriage returns and line-feeds separating lines) and contain two
  601.      values on each line of the file.  Each of the two values must be in the
  602.      range 0-255.
  603.  
  604.      The first value specifies the source (original, old) character's binary
  605.      value, the second value specifies the destination (new) binary value for
  606.      that character.  Thus, to convert ESC characters (Hex '1B', decimal 27)
  607.      to NULL characters (Hex '00', decimal 0), and to convert lower case
  608.      `a' through `e' to upper case `A' through `E', one would build a file
  609.      containing the following lines:
  610.  
  611.            027 000                  * ESC to NULL
  612.            097 065                  * a to A
  613.            098 066                  * b to B
  614.            099 067                  * c to C
  615.            100 068                  * d to D
  616.            101 069                  * e to E
  617.  
  618.  
  619.  
  620.      Turbo Pascal I/O (Input/Output) Error Codes                      Page 14
  621.      -------------------------------------------                      -------
  622.  
  623.      If the message "I/O error; Code = ddd" appears (ddd represents a 3-digit
  624.      number), then some type of I/O error has occured.  If the code is in the
  625.      range 1-99, it is a DOS code (see IBM DOS Technical Reference Manual).  A
  626.      few examples of DOS codes are:
  627.  
  628.          2  "File not found" - Should never appear
  629.  
  630.          3  "Path not found" - Should never appear
  631.  
  632.          4  "Too many files Open" - MS/DOS only allows a certain number of
  633.             files to be opened simultaneously.  Check your MS/DOS documentation
  634.             about the "FILES=" parameter in the CONFIG.SYS file.
  635.  
  636.          5  "File Access Denied" - The file's DOS "mode" bits (in the file's
  637.             directory) do not allow the attempted operation on the file.
  638.  
  639.          6  "Invalid File Handle" - Should never appear
  640.  
  641.         34  "ASSIGN to STD files not allowed' - Must be an AD-EDIT logic bug.
  642.  
  643.  
  644.      Codes greater than 99 are generated by Turbo-Pascal:
  645.  
  646.        100  "Seek beyond end of file" - Should never appear
  647.  
  648.        101  "Disk Write Error" - AD-EDIT displays the message "ERROR:
  649.             DISK IS FULL" for this code.
  650.  
  651.  
  652.      In any case-  if a strange error occurs, call!
  653.  
  654.  
  655.      Anticipated/Requested Enhancements  ("If I ever get to it ...")  Page 15
  656.      ----------------------------------                               -------
  657.  
  658.      (By the way; priority is always given to fixing bugs over installing
  659.      new features or enhancements)
  660.  
  661.      A "flow text" function to line-fill areas of text
  662.  
  663.      EBCDIC-to-ASCII and ASCII-to-EBCDIC .Xlt files for mainframe-connected
  664.      users (provided I can find a reasonable authority source for such
  665.      a translate table)
  666.  
  667.      Make the status line appear in reverse-video mode on a monochrome
  668.      monitor (this seems to be a Turbo-Pascal bug).
  669.  
  670.  
  671.      Requested/Suggested but Rejected Changes  ("Excuses, Excuses")   Page 16
  672.      ----------------------------------------                         -------
  673.  
  674.      Allow re-assigning keys: I think there are just too many keyboard
  675.           enhancers, macro processors, etc. etc. etc. for AD-EDIT to have this
  676.           feature built-in; I've already got one user who uses a resident
  677.           keyboard enhancer to make AD-EDIT work like the editor on an NCR
  678.           mainframe.  No way can I compete....
  679.  
  680.  
  681.      Quit using the F_ (Function) keys; use stuff like Ctrl-K-D instead of
  682.           <End>, and <PgUp>:
  683.  
  684.           1. See above under "re-assigning keys"
  685.  
  686.           2. (Philosophical Opinion) The F_ keys were put on the IBM keyboard
  687.              to invoke program functions; the Ctrl-K-D stuff is a holdover from
  688.              ancient days (3-4 years ago) when most PCs didn't have the F_ keys.
  689.              Therefore, I think I'm doing the proper thing by avoiding them.
  690.  
  691.           3. Lots of folks are already using Memory-Resident programs that use
  692.              Ctrl-Alt-Shift-etc combinations to wake themselves up.  None of
  693.              the ones I've got use the F_ keys, so there's no conflict.
  694.  
  695.           4. (Bald-Face Prejudice) I grew up using IBM mainframes; IBM
  696.              consoles (and later, terminals) always had PF (Program Function)
  697.              keys.  I like 'em, I want 'em, I got 'em.
  698.  
  699.  
  700.  
  701.      AD-EDIT Revision level History  ("How I got here from there")      Page 17
  702.      ------------------------------                                     -------
  703.  
  704.  
  705.      2.12       Performance: Optimized screen I/O so that only data-bytes (and
  706.                 not attribute bytes) are re-written; removed extra colors for
  707.                 window borders and cursor-defined boxes
  708.  
  709.      2.13       Code Size/Performance: Tuned HELP facility for extra
  710.                 screen-write speed, and reduced core requirements for code+data.
  711.  
  712.      2.14       Performance: Tuned the window-management routines for speed-
  713.                 replaced calls to Turbo routines with Assembler subroutine
  714.  
  715.      2.15       Added "Exit without saving changes" confirmation message; added
  716.                 I/O error detection handlers; reduced no. of reserved lines at
  717.                 bottom of screen from 3 to 1.
  718.  
  719.      2.16       Fixed "Cursor Defined" message that did not clear after using
  720.                 Esc to exit from cursor-definition mode; changed exit routine to
  721.                 display last message after clearing screen.
  722.  
  723.      2.17       Fixed cursor location problem (causing wild scroll) after
  724.                 splitting screen horizontally; changed exit routine to set text
  725.                 color to light gray (like DOS default) instead of brilliant
  726.                 white; fixed erroneous "No function for that key" message for
  727.                 F2 (Set tab).
  728.  
  729.      2.18       Added code to allow editing of filenames with no extension, and
  730.                 added search for default extensions if none is supplied.
  731.  
  732.      2.19       Added Spell-Check interface to Turbo Lightning.
  733.      (12/01/86)
  734.  
  735.      2.20       Made optimizations; added read-ahead processing
  736.      12/13/86   to prevent keyboard buffer from filling up and to eliminate
  737.                 "drift" when user holds down a key for a relatively long
  738.                 operation (like close-line, scroll, etc).
  739.  
  740.                 Fixed bug that caused a 'Wrap-around' effect when
  741.                 restoring PCP boxes and not enough file lines were left.
  742.  
  743.      2.21       Added Translation facilities: Upper case, Lower case and Table
  744.      01/23/87   driven.  The ".Xlt" files were added to the AD-EDIT distribution
  745.                 package.
  746.  
  747.                 Corrected glitch in Find/Change commands that caused
  748.                 status line to not be cleared when user hit ESC during input of
  749.                 a parameter.
  750.  
  751.  
  752.      AD-EDIT Revision level History                                   Page 18
  753.      ------------------------------                                   -------
  754.  
  755.  
  756.      2.22
  757.      01/24/87   Added confirmation ANY TIME the <End> key is used (several
  758.                 users had complained about accidentally hitting <End> while
  759.                 groping for one of the cursor keys...)
  760.  
  761.                 Deleted most of the window-management code that tried to keep
  762.                 the whole 24x80 screen in use (seemed to confuse most users
  763.                 when window sizes changed 'automatically').
  764.  
  765.                 'Fixed the bug' (I thought of it as a 'feature') that treated
  766.                 2 filenames as different if the capitalization was different;
  767.                 now all filenames are carried in upper case.
  768.  
  769.                 Fixed a bug that caused an Endless Loop when using <End>
  770.                 with more than 2 un-modified files loaded into Windows.
  771.  
  772.       2.23      Fixed bug that caused DOS to crash if "Out of Memory" occurred
  773.       01/31/87  while loading the first file.
  774.  
  775.                 Added code to give "Error: Disk is full!" message anytime this
  776.                 error occurs during file output; AD-EDIT does not terminate,
  777.                 allowing the file to be saved on another disk/etc.  Added code
  778.                 to provide the Turbo Pascal I/O error code for any other I/O
  779.                 error (also added list of these codes to the .DOC file).
  780.  
  781.                 Added "Table of Contents" page to .DOC file, at suggest of
  782.                 several users.
  783.  
  784.  
  785.       2.24a     (Released for Beta-Testing only)
  786.       05/02/87
  787.  
  788.                 Re-structured program to allow easy replacement of the video
  789.                 I/O routines; created EDITA program using ANSI.SYS screen
  790.                 control; added LOGIMOUSE menu definition file.
  791.  
  792.       2.25
  793.       08/27/87
  794.                 Added Alt-F5 "Print File" function after being convinced by
  795.                 a call from a (Paying) user.  Also documented how to to zap
  796.                 the screen colors and default printer name.  Tossed the
  797.                 ANSI version of AD-EDIT after several abortive attempts to
  798.                 implement under various BBS systems and Modem packages.  See
  799.                 "Enhancements" under "ANSI AD-EDIT".  Created new "AD-EBBS"
  800.                 product.
  801.  
  802.  
  803.      AD-EDIT Revision level History                                   Page 19
  804.      ------------------------------                                   -------
  805.  
  806.  
  807.       2.26
  808.       09/30/87
  809.                 Added "DESQview awareness"; AD-EDIT will run in "small windows"
  810.                 or in background under DESQview.  Added a default tab-stop
  811.                 in columns 1 and 80 (allows tab/back-tab keys to position at
  812.                 end/start-of-line).  Added recognition of active monitor
  813.                 on multi-monitor systems.  Added code to skip video-sync
  814.                 processing on MDA and EGA. Documented patch to disable
  815.                 video sync unconditionally.  Fixed several "glitches" when
  816.                 running under IBM's "3270 PC Control Program".  Fixed a bug
  817.                 causing back-tab from cols 73-80 to act screwy.  Added
  818.                 additional editing functions when inputting parameters
  819.                 to FIND/CHANGE/etc
  820.  
  821.       3.00
  822.       01/17/88
  823.                 Converted to Turbo-Pascal Version 4.00; Changed "xx% Free" on
  824.                 status line to "xxxK Free"
  825.  
  826.       3.01      Fixed bug in "find" routine that sometimes caused spurious
  827.       03/03/88  "hits".  Modified word-wrap on last line of file to scroll down
  828.                 1 line and correctly position cursor.
  829.  
  830.  
  831.      Changing Defaults                                                Page 20
  832.      -----------------                                                -------
  833.  
  834.      The following describes how to "patch" the ADEDIT.EXE file, using the
  835.      DOS "debug" command, to change certain default values.  Unless you are
  836.      familiar with "debug", please don't try this.  Unless you are very, very,
  837.      confident about using "debug" DON'T USE YOUR ONE-AND-ONLY COPY OF
  838.      ADEDIT.EXE!!!
  839.  
  840.      Colors
  841.      ------
  842.  
  843.      Locate the color settings by searching for "[COLORS]"; the following 7
  844.      bytes specify the colors (in this order) for:
  845.  
  846.               Foreground of Data portion of screen    (Default: 06 (Brown))
  847.               Background of Data portion of screen    (Default: 00 (Black))
  848.               Border of the screen                    (Default: 08 (Dark Gray))
  849.  
  850.               Foreground of "Status Line"             (Default: 00 (Black))
  851.               Background of "Status Line"             (Default: 02 (Green))
  852.  
  853.               Foreground of HELP screen               (Default: 0F (White))
  854.               Background of HELP screen               (Default: 01 (Blue))
  855.  
  856.      The values to set are:
  857.  
  858.           00: Black       04: Red           08: DarkGray      0C: LightRed
  859.           01: Blue        05: Magenta       09: LightBlue     0D: LightMagenta
  860.           02: Green       06: Brown         0A: LightGreen    0E: Yellow
  861.           03: Cyan        07: LightGray     0B: LightCyan     0F: White
  862.  
  863.  
  864.      Default Printer
  865.      ---------------
  866.  
  867.      Search for the string "[PRINTER]"; immediately following should be a
  868.      a byte giving the maximum length of the default printer name (originally
  869.      09 in release 2.25).  Insert the new name, padding the field to its
  870.      maximum length with blanks (Value: Hex 20).
  871.  
  872.  
  873.      Disabling Video Synchronization (for non-IBM CGA-compatible cards)
  874.      -----------------------------------------------------------------
  875.  
  876.      Search for the string "[NORETRACE]"; immediately following should be a
  877.      byte of hex 0 (00H, X'00').  Set this byte to disable synchronizing
  878.      video updates with video retrace states.
  879.  
  880.  
  881.      Changing Defaults                                                Page 21
  882.      -----------------                                                -------
  883.  
  884. Example: Transcript of changing the data screen to Blue characters on
  885.          a Yellow background with a White Border
  886.  
  887.          (Offsets shown should not be used as-is: they may differ on your
  888.          machine, and WILL differ from release-to-release of AD-EDIT!!)
  889.  
  890. -r
  891.  
  892. AX=0000  BX=0000  CX=9668  DX=0000  SP=FFFE  BP=0000  SI=0000  DI=0000
  893. DS=0E7E  ES=0E7E  SS=0E7E  CS=0E7E  IP=0100   NV UP EI PL NZ NA PO NC
  894. 0E7E:0100 E9792C        JMP    2D7C
  895.  
  896. -s cs:0100 l 9668 "[COLORS]"
  897.  
  898. 0E7E:2E2B
  899.  
  900. -d 0e7e:2e2b
  901.  
  902. 0E7E:2E20                                   5B 43 4F 4C 4F              [COLO
  903. 0E7E:2E30  52 53 5D 06 00 08 00 02-0F 01 5B 50 52 49 4E 54   RS].......[PRINT
  904. 0E7E:2E40  45 52 5D 09 4C 50 54 31-20 20 20 20 20 55 8B EC   ER].LPT1     U..
  905. 0E7E:2E50  55 E9 00 00 83 EC 14 B8-02 00 88 46 EB 8B 46 04   U..........F..F.
  906. 0E7E:2E60  48 88 46 F1 8B 46 06 48-88 46 F0 B8 00 00 88 46   H.F..F.H.F.....F
  907. 0E7E:2E70  ED 8D 7E EA 16 E8 EF E0-CD 10 E8 12 E1 E9 00 00   ..~.............
  908. 0E7E:2E80  8B E5 5D C2 04 00 55 8B-EC 55 E9 00 00 B8 01 00   ..]...U..U......
  909. 0E7E:2E90  88 46 04 B8 00 00 50 B8-10 04 97 07 26 8A 05 32   .F....P.....&..2
  910. 0E7E:2EA0  E4 25 03 00 3D 03 00 74-03 E9 06                  .%..=..t...
  911.  
  912. -e 2e33
  913.  
  914. 0E7E:2E33  06.01   00.0e   08.0f
  915.  
  916. -w
  917.  
  918. Writing 9668 bytes
  919. -q
  920.